<?php
/**
 * <https://y.st./>
 * Copyright © 2017 Alex Yst <mailto:copyright@y.st>
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <https://www.gnu.org./licenses/>.
**/

$xhtml = array(
	'<{title}>' => "Limiting my use of characters in $a[URI]s",
	'<{body}>' => <<<END
<section id="general">
	<h2>General news</h2>
	<p>
		<code>https:</code>- and <code>http:</code>-scheme $a[URI] syntax isn&apos;t really defined.
		At all.
		$a[RFC] 3986 defines general $a[URI] syntax, which includes potential delimiters for specific schemes to use, and $a[RFC] 7230 sets aside the schemes themselves for use to identify Web files.
		However, without scheme-specific syntax defined, it&apos;s hard to say whether it&apos;s fine to use sometimes-delimiters in Web addresses.
		It&apos;s not technically <strong>*disallowed*</strong> though, so at first, I used an apostrophe in the $a[URI] of my essay submission for the week.
		I later realized that was a bad idea and changed it though.
		The problem is the ambiguity.
		On one side of the argument, you could say that the ambiguity prevents us from knowing whether these characters need to be encoded in <code>https:</code>-scheme $a[URI]s.
		Perhaps they&apos;re <strong>*required*</strong> to be encoded, but perhaps they&apos;re <strong>*required*</strong> to be unencoded.
		We just don&apos;t know, so it&apos;s safest to avoid those characters altogether.
		I take the other side though.
		I think both options are allowed.
		And that&apos;s where <strong>*my*</strong> reason not to use them comes in.
		They&apos;re both allowed, but unless your Web server is set up to handle all potential delimiters as having a meaning outside of $a[HTTP] itself, the $a[URI] with the encoded character and the $a[URI] with the unencoded character will point to the same file.
		Unless you have a special setup, keeping one and only one $a[URI] pointing to the page requires that you not use these ambiguously-allowed characters.
		Sure, having use of a slightly-larger character set is nice, but not when it causes ambiguity issues, such as having a page under two $a[URI]s.
		(Which $a[URI] is the correct one?)
	</p>
	<p>
		I was supposed to stop at the credit union before work, but due to my variable work schedule, I thought that I was supposed to head into work an hour after I was really supposed to leave.
		I caught the mistake just as I was headed out, and had to head strait to work instead of hitting up the credit union first.
		I&apos;ll just have to hope the cash I have on hand is enough for tomorrow, when I go to the Value Village sale.
	</p>
	<p>
		I had a customer come through the drive-through with the smallest order I&apos;ve seen so far: a single cup of marinara sauce, which costs fifty cents.
		I think that&apos;s our cheapest item, so I&apos;m not going to see any smaller orders later, either.
		Later, a customer placed an order at the menu board, and when I asked them to pay at the window, they instead drove off.
		I had no choice but to cancel their order.
		Later, they came by to pick it up, but obviously, we didn&apos;t have it.
		They ended up having to wait again just because they didn&apos;t listen the first time and pay for their order.
		If you don&apos;t pay for your order, we can&apos;t make it for you.
	</p>
	<p>
		Toward the end of the night, the power went out on us.
		Right as I got my mobile&apos;s flashlight turned on though, the power came back.
		A later customer reported seeing emergency vehicles including ambulances, so it&apos;s possible someone hit a power pole or something and knocked out our electricity for a few seconds.
	</p>
	<p>
		My <a href="/a/canary.txt">canary</a> still sings the tune of freedom and transparency.
	</p>
</section>
<section id="university">
	<h2>University life</h2>
	<p>
		I&apos;ve written up a first draft of my <a href="/en/coursework/PHIL1404/Caveat_emptor_and_the_McDonald~s_coffee_case.xhtml">essay</a> for the week, though I haven&apos;t completed the reading assignment yet.
		I might add more details if I come across something useful in the textbook later.
	</p>
</section>
END
);
